home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / nftroff.zip / 15.tr < prev    next >
Text File  |  1991-11-21  |  33KB  |  1,480 lines
  1. .de }n
  2. .bp
  3. .sp .5i
  4. ..
  5. .wh -.8i }n
  6. .sp .5i
  7. .po -.4i
  8. .ll 7.5i
  9. .ps 9
  10. .vs 9
  11. .in 0i
  12. .sp 2
  13. .ne 20
  14. .ps +3
  15. .vs +3
  16. Overview, Part 1
  17. .br
  18. .ps -3
  19. .vs -3
  20. .sp 2
  21. .sp
  22. .in 0.24i
  23. .ta 3.92i
  24. NANFOR\.LIB Working Group    G\. Scott [71620,1521]
  25. .br
  26. .ta
  27. .ta 5.28i
  28. Request for Comments    UCLA
  29. .br
  30. .ta
  31. .ta 4.72i
  32. Version 1\.0    March, 1991
  33. .br
  34. .ta
  35. .sp
  36. .in 1.76i
  37. \fBTHE NANFORUM TOOLKIT (NANFOR\.LIB)
  38. .in 0.96i
  39. \fBPUBLIC DOMAIN USER SUPPORTED CLIPPER FUNCTION LIBRARY
  40. .sp
  41. .in 0.24i
  42. .ta 0.4i
  43. \fB1    INTRODUCTION
  44. .br
  45. .ta
  46. .sp
  47. .in 0.64i
  48. This is a standard for establishing and maintaining NANFOR\.LIB, a
  49. public-domain, user-supported library of functions designed to
  50. interface with Nantucket Clipper, version 5\.0, and later\.  You
  51. are encouraged to read it over and forward comments to Glenn
  52. Scott, CIS ID [71620,1521]\.
  53. .sp
  54. .ta 0.4i
  55. \fB1\.1    History
  56. .br
  57. .ta
  58. .sp
  59. .in 1.04i
  60. In October and November of 1990, a discussion on the
  61. evolution of third-party products, vendors, and marketing
  62. took place on the CompuServe Information Service\'s Nantucket
  63. Forum (NANFORUM)\.  During this discussion, a NANFORUM
  64. subscriber named Alexander Santic suggested the idea of a
  65. user-supported Clipper function library, available to all on
  66. the CompuServe Information Service (CIS)\.  A number of
  67. subscribers, including several Clipper third party
  68. developers, and some Nantucket employees, expressed their
  69. support\. This standard is a first step toward organizing
  70. such an endeavor\.
  71. .sp
  72. .in 0.64i
  73. .ta 0.4i
  74. \fB1\.2    Trademarks
  75. .br
  76. .ta
  77. .sp
  78. .in 1.04i
  79. Clipper is a registered trademark of Nantucket Corporation\.
  80. .sp
  81. .in 0.64i
  82. .ta 0.4i
  83. \fB1\.3    Relationship to Nantucket and third party
  84. .br
  85. .ta
  86. .sp
  87. .in 1.04i
  88. NANFOR\.LIB is a project independent of any third party
  89. developer or Nantucket Corporation\.  There is no official
  90. "sanction" or "seal of approval" from Nantucket of any kind\.
  91. In addition, NANFOR\.LIB routines will be accepted and
  92. included without regard for whether or not routines
  93. performing a similar function are included in a commercial
  94. third party or Nantucket product\.
  95. .sp
  96. It is desired that NANFOR\.LIB not compete with third party
  97. products but rather fill in the holes in Clipper\'s standard
  98. library\.  However, there will be some overlap into
  99. commercial third-party library functions, so it would be
  100. best if this is never taken into consideration when deciding
  101. on including a particular function\.
  102. .sp
  103. Developers submitting NANFOR\.LIB routines can and will be
  104. corporate developers, third party developers, independent
  105. consultant / programmers, hobbyists, and other Clipper
  106. people\.  Perhaps even Nantucket employees will contribute\.
  107. No one is excluded or included due to any particular
  108. affiliation\.
  109. .sp
  110. Nantucket employees submitting functions are doing so as
  111. individuals, and are not making a policy of involving
  112. Nantucket in the project, nor are they committing Nantucket
  113. to supporting the public domain library\.
  114. .sp
  115. .in 0.64i
  116. .ta 0.4i
  117. \fB1\.4    Clipper version supported
  118. .br
  119. .ta
  120. .sp
  121. .in 1.04i
  122. NANFOR\.LIB functions, no matter what language they are
  123. written in, will be designed to work with Clipper version
  124. 5\.0 and later\.  Many of the functions, particularly those
  125. that use the EXTEND system, will be compatible with the
  126. Summer 1987 version of Clipper\. However, ensuring Summer 87
  127. compatibility will be the responsibility of the user\.  If a
  128. user wants a function to work with Summer 87, she will have
  129. to modify the code herself if necessary\.  In many cases,
  130. this is a trivial task\.
  131. .sp
  132. .in 0.64i
  133. .ta 0.4i
  134. \fB1\.5    Queries from new users
  135. .br
  136. .ta
  137. .sp
  138. .in 1.04i
  139. Queries from new users interested in finding NANFOR\.LIB will
  140. be handled in a uniform and courteous way\.  A short text
  141. file will be created that will briefly explain NANFOR\.LIB,
  142. who the current people maintaining it are, and how to get a
  143. hold of it\.  This text message will be sent in response to
  144. any query\.  TAPCIS users will find this method very easy to
  145. implement\.
  146. .sp
  147. .in 0.24i
  148. .ta 0.4i
  149. \fB2    DISTRIBUTION
  150. .br
  151. .ta
  152. .sp
  153. .in 0.64i
  154. .ta 0.4i
  155. \fB2\.1    Public Domain
  156. .br
  157. .ta
  158. .sp
  159. .in 1.04i
  160. NANFOR\.LIB, its source code, and documentation will be
  161. public-domain software\.  It is not for "sale", and shall not
  162. be sold\.  No fee or contribution of any kind will be
  163. required for anyone wanting a copy, other than what they
  164. would normally pay to download it from CompuServe\. Users
  165. will be encouraged to submit functions via CompuServe\.
  166. .sp
  167. .in 0.64i
  168. .ta 0.4i
  169. \fB2\.2    Official repository
  170. .br
  171. .ta
  172. .sp
  173. .in 1.04i
  174. It is possible that copies of NANFOR\.LIB will be downloaded
  175. and distributed elsewhere\.  That is all right, but the only
  176. copy of NANFOR\.LIB and all associated documentation that
  177. will be maintained by volunteers is in an appropriate
  178. library on the CIS Nantucket Forum\.
  179. .sp
  180. .ta 0.8i
  181. \fB2\.2\.1    Contents
  182. .br
  183. .ta
  184. .sp
  185. .in 1.84i
  186. The nature of the official posting on CompuServe
  187. shall be:
  188. .sp
  189. .in 1.44i
  190. .ta 0.8i
  191. 2\.2\.1\.1    NFLIB\.ZIP
  192. .br
  193. .ta
  194. .sp
  195. .in 2.24i
  196. This will contain the files NANFOR\.LIB
  197. (library), and NANFOR\.NG (Norton Guide)\.
  198. .sp
  199. .in 1.44i
  200. .ta 0.8i
  201. 2\.2\.1\.2    NFSRC\.ZIP
  202. .br
  203. .ta
  204. .sp
  205. .in 2.24i
  206. This will contain all the library source
  207. code, makefile, and other source-code related
  208. materials\.
  209. .sp
  210. .in 1.44i
  211. .ta 0.8i
  212. 2\.2\.1\.3    FTINQ\.TXT
  213. .br
  214. .ta
  215. .sp
  216. .in 2.24i
  217. This is a short text file used as a response
  218. to new user queries (see paragraph 1\.5)
  219. .sp
  220. .in 1.44i
  221. .ta 0.8i
  222. 2\.2\.1\.4    NFRFC\.ZIP
  223. .br
  224. .ta
  225. .sp
  226. .in 2.24i
  227. This contains an ASCII copy of NANFOR\.RFC
  228. (this document) named NFRFC\.TXT\.
  229. .sp
  230. .in 1.44i
  231. .ta 0.8i
  232. 2\.2\.1\.5    NFHDRS\.ZIP
  233. .br
  234. .ta
  235. .sp
  236. .in 2.24i
  237. This contains templates of the file and
  238. documentation header blocks, including a
  239. sample, for prospective authors (FTHDR\.PRG,
  240. FTHDR\.ASM, FTHDR\.SAM)
  241. .sp
  242. .sp
  243. .in 0.24i
  244. .ta 0.4i
  245. \fB3    POLICY ON INCLUDING FUNCTIONS
  246. .br
  247. .ta
  248. .sp
  249. .in 0.64i
  250. .ta 0.4i
  251. \fB3\.1    "Best Function"
  252. .br
  253. .ta
  254. .sp
  255. .in 1.04i
  256. It is possible that more than one developer will submit a
  257. function or package of functions that perform substantially
  258. the same services\.  In that event, the referees will choose
  259. one to be included based on power, functionality,
  260. flexibility, and ease of use\.  Due to the cooperative,
  261. non-commercial nature of the library, no one\'s feelings
  262. should be hurt by excluding duplicate functions\.
  263. .sp
  264. In addition, it is possible that two substantially
  265. similar functions or packages will benefit from merging them
  266. together to provide new functionality\.  This will be the
  267. prerogative of the referees (see paragraph 6\.3), in
  268. consultation with the author, if possible\.
  269. .sp
  270. .in 0.64i
  271. .ta 0.4i
  272. \fB3\.2    Public Domain
  273. .br
  274. .ta
  275. .sp
  276. .in 1.04i
  277. .ta 4.56i
  278. Each author submitting source code must include as part    of
  279. .br
  280. .ta
  281. that code a statement that this is an original work and that
  282. he or she is placing the code into the public domain\. The
  283. librarian (see paragraph 6\.1) and referees should make a
  284. reasonable effort to be sure no copyrighted source code,
  285. such as that supplied with some third party libraries, makes
  286. it into NANFOR\.LIB\.  However, under no circumstances will
  287. the librarian, referees, or any other party other than the
  288. submitter be responsible for copyrighted code making it into
  289. the library accidentally\.
  290. .sp
  291. .in 0.64i
  292. .ta 0.4i
  293. \fB3\.3    Source code
  294. .br
  295. .ta
  296. .sp
  297. .in 1.04i
  298. Full source code must be provided by the author for every
  299. routine to be included in NANFOR\.LIB\.  No routine, no matter
  300. what language, will be put into the library on the basis of
  301. submitted object code\.
  302. .sp
  303. .in 0.64i
  304. .ta 0.4i
  305. \fB3\.4    Proper submission
  306. .br
  307. .ta
  308. .sp
  309. .in 1.04i
  310. Due to the volume of submissions expected, librarians and
  311. referees may not have the time to fix inconsistencies in
  312. documentation format, function naming, and other
  313. requirements\.  Therefore, the librarian shall expect source
  314. code to arrive in proper format before proceeding further
  315. with it\.
  316. .sp
  317. .in 0.64i
  318. .ta 0.4i
  319. \fB3\.5    Quality and perceived usefulness
  320. .br
  321. .ta
  322. .sp
  323. .in 1.04i
  324. In a cooperative effort like this, it is very difficult to
  325. enforce some standard of quality and/or usefulness\.  For
  326. example, a package of functions to handle the military\'s
  327. "Zulu time" may be very useful to some, and unnecessary to
  328. others\.
  329. .sp
  330. The Nanforum Toolkit will by its very nature be a hodgepodge
  331. of routines, some of very high quality, some not so high\.
  332. It is up to